package com.zhai.trigger.api;

import com.zhai.trigger.dto.*;
import com.zhai.types.model.Response;

import java.util.List;

/**
 * @Description: 抽奖服务接口
 * @ClassName: IRaffleService
 * @Author: zhaiyongxin
 * @Date: 2025/2/10 15:02
 * @Version: 1.0
 */
public interface IRaffleStrategyService {

    /**
     * 策略装配接口
     * @param strategyId 策略id
     * @return 装配结果
     */
    Response<Boolean> strategyArmory(Long strategyId);

    /**
     * 查询策略奖品列表
     * @param raffleAwardListRequestDTO 奖品列表请求
     * @return
     */
    Response<List<RaffleAwardListResponseDTO>> queryRaffleAwardList(RaffleAwardListRequestDTO raffleAwardListRequestDTO);


    /**
     * 随机抽奖接口
     * @param raffleStrategyRequestDTO
     * @return
     */
    Response<RaffleStrategyResponseDTO> randomRaffle(RaffleStrategyRequestDTO raffleStrategyRequestDTO);


    /**
     * 查询抽奖策略权重规则，给用户展示出抽奖N次后必中奖奖品范围
     *
     * @param request 请求对象
     * @return 权重奖品配置列表「这里会返回全部，前端可按需展示一条已达标的，或者一条要达标的」
     */
    Response<List<RaffleStrategyRuleWeightResponseDTO>> queryRaffleStrategyRuleWeight(RaffleStrategyRuleWeightRequestDTO request);

}
